IBM InfoROM for OS/2 Beta 1995 January

home *** CD-ROM | disk | FTP | other *** search

/ IBM InfoROM for OS/2 Beta 1995 January / IBM InfoROM for OS2 Beta 1-1995.ISO / testcert / storage / function / scsi / add / scsiadd.gra < prev next >

Wrap

Text File | 1994-08-15 | 37.2 KB | 836 lines

****************************************************************************** ** SCSIADD GRA DESCRIPTION FILE ** ****************************************************************************** @IMPORT GLOBAL.GRA ****************************************************************************** ** THE FOLLOWING FUNCTION OPENS TEST DEVICE DRIVER: DASDADD$ (DASDADD.SYS) ** ** REQUIRED INPUT PARAMETERS: NONE ** ** OUTPUT PARAMETERS: DRIVEHANDLE ( SETS ) ** ** LOGGED DATA: NONE ** dd_open $DLL=SCSIADD \ $FUNC=_scsiadd_open ****************************************************************************** ** THE FOLLOWING FUNCTION GETS ALL INSTALLED DRIVERS OF DASD CLASS ** ** REQUIRED INPUT PARAMETERS: DRIVEHANDLE (SET BY DD_OPEN) ** ** OUTPUT PARAMETERS: NONE ** ** LOGGED DATA: PRINTS THE NAMES OF ALL THE INSTALLED ** DASD CLASS DRIVERS ** dd_GetDrivers $DLL=SCSIADD \ DRIVEHANDLE=NUM \ $FUNC=_scsiadd_GetDrivers ****************************************************************************** ** THE FOLLOWING FUNCTION GETS THE DEVICETABLE FOR A GIVEN ADAPTER DEV DRIVER ** ** REQUIRED INPUT PARAMETERS: DRIVEHANDLE (SET BY DD_OPEN) ** DRVNAME - CHARACTER DRIVER NAME ** MODE - (0 OR 1) OPTIONAL ** DEFAULT=0 (ASYNC MODE) ** ** OUTPUT PARAMETERS: NONE ** ** LOGGED DATA: PRINTS THE DEVICE TABLE FOR THE GIVEN ** DRIVER. THE DEVICE TABLE CONTAINS ** DETAILED INFO ON EACH ADAPTER AND THE ** ATTACHED UNITS SUPPORTED BY THE ** ADAPTER DEVICE DRIVER. ** ( NO. OF ADAPTERS PRESENT, ** NO. OF UNITS ATTACHED, ** UNIT FLAGS, ** UNIT HANDLE ...... ) ** dd_GetDeviceTable $DLL=SCSIADD \ DRIVEHANDLE=NUM \ DRVNAME=STRING \ $FUNC=_scsiadd_GetDeviceTable ****************************************************************************** ** THE FOLLOWING FUNCTION SENDS A CDB FOR TWELVE-BYTE COMMANDS ** ** REQUIRED INPUT PARAMETERS: DRIVEHANDLE (SET BY DD_OPEN) ** ** DRVNAME - CHARACTER DRIVER NAME ** ** MODE - (0 OR 1) OPTIONAL ** DEFAULT=0 (ASYNC MODE) ** ** UNITHANDLE - SET IN SCSICOM.SCR. ** THIS IS OBTAINED BY ** CALLING DD_GETDEVICETABLE ** ** MEMSIZE - TOTAL BYTES IN SCAT/GAT LIST ** ** NBUFF - NO. OF ELEMENTS IN SCAT/GAT ** ** TIMEOUT - COMMAND COMPLETION TIMEOUT ** (SECS) ** ( 0 = DEFAULT SET BY DRIVER ** -1 = INFINITE ) ** ** CDB_BYTE0 - OPERATION CODE ** ** CDB_BYTE1 - BITS 0-4: COMMAND SPECIFIC ** - BITS 5-7: LUN (ZERO) ** ** ( 32BIT STARTING LOGICAL BLOCK ADDR ) ** CDB_BYTE2 - MSB ** CDB_BYTE3 ** CDB_BYTE4 ** CDB_BYTE5 - LSB ** ** ( COMMAND SPECIFIC ** - TRANSFER LENGTH, ** PARAMETER LIST LENGTH OR ** ALLOCATION LENGTH ) ** CDB_BYTE6 - MSB ** CDB_BYTE7 ** CDB_BYTE8 ** CDB_BYTE9 - LSB ** ** CDB_BYTE10 - RESERVED ** ** CDB_BYTE11 - CONTROL FIELD ** BIT 0: LINK BIT ** BIT 1: FLAG BIT ** BITS 2-5: RESERVED ** BITS 6-7: VENDOR SPECIFIC dd_CDB12 $DLL=SCSIADD \ DRIVEHANDLE=NUM \ DRVNAME=STRING \ MODE=NUM \ UNITHANDLE=NUM \ MEMSIZE=NUM \ NBUFF=NUM \ TIMEOUT=NUM \ CDB_BYTE0=NUM \ CDB_BYTE1=NUM \ CDB_BYTE2=NUM \ CDB_BYTE3=NUM \ CDB_BYTE4=NUM \ CDB_BYTE5=NUM \ CDB_BYTE6=NUM \ CDB_BYTE7=NUM \ CDB_BYTE8=NUM \ CDB_BYTE9=NUM \ CDB_BYTE10=NUM \ CDB_BYTE11=NUM \ $FUNC=_scsiadd_CDB12 ****************************************************************************** ** THE FOLLOWING FUNCTION SENDS A CDB FOR TEN-BYTE COMMANDS ** ** REQUIRED INPUT PARAMETERS: DRIVEHANDLE (SET BY DD_OPEN) ** ** DRVNAME - CHARACTER DRIVER NAME ** ** MODE - (0 OR 1) OPTIONAL ** DEFAULT=0 (ASYNC MODE) ** ** UNITHANDLE - SET IN SCSICOM.SCR. ** THIS IS OBTAINED BY ** CALLING DD_GETDEVICETABLE ** ** MEMSIZE - TOTAL BYTES IN SCAT/GAT LIST ** ** NBUFF - NO. OF ELEMENTS IN SCAT/GAT ** ** TIMEOUT - COMMAND COMPLETION TIMEOUT ** (SECS) ** ( 0 = DEFAULT SET BY DRIVER ** -1 = INFINITE ) ** ** CDB_BYTE0 - OPERATION CODE ** ** CDB_BYTE1 - BITS 0-4: COMMAND SPECIFIC ** - BITS 5-7: LUN (ZERO) ** ** ( 32BIT STARTING LOGICAL BLOCK ADDR ) ** CDB_BYTE2 - MSB ** CDB_BYTE3 ** CDB_BYTE4 ** CDB_BYTE5 - LSB ** ** CDB_BYTE6 - RESERVED ** ** ( COMMAND SPECIFIC ** - TRANSFER LENGTH, ** - PARAMETER LIST LENGTH OR ** - ALLOCATION LENGTH ) ** CDB_BYTE7 - MSB ** CDB_BYTE8 - LSB ** ** CDB_BYTE9 - CONTROL FIELD ** BIT 0: LINK BIT ** BIT 1: FLAG BIT ** BITS 2-5: RESERVED ** BITS 6-7: VENDOR SPECIFIC dd_CDB10 $DLL=SCSIADD \ DRIVEHANDLE=NUM \ DRVNAME=STRING \ MODE=NUM \ UNITHANDLE=NUM \ MEMSIZE=NUM \ NBUFF=NUM \ TIMEOUT=NUM \ CDB_BYTE0=NUM \ CDB_BYTE1=NUM \ CDB_BYTE2=NUM \ CDB_BYTE3=NUM \ CDB_BYTE4=NUM \ CDB_BYTE5=NUM \ CDB_BYTE6=NUM \ CDB_BYTE7=NUM \ CDB_BYTE8=NUM \ CDB_BYTE9=NUM \ $FUNC=_scsiadd_CDB10 ****************************************************************************** ** THE FOLLOWING FUNCTION SENDS A CDB FOR SIX-BYTE COMMANDS ** ** REQUIRED INPUT PARAMETERS: DRIVEHANDLE (SET BY DD_OPEN) ** ** DRVNAME - CHARACTER DRIVER NAME ** ** MODE - (0 OR 1) OPTIONAL ** DEFAULT=0 (ASYNC MODE) ** ** UNITHANDLE - SET IN SCSICOM.SCR. ** THIS IS OBTAINED BY ** CALLING DD_GETDEVICETABLE ** ** MEMSIZE - TOTAL BYTES IN SCAT/GAT LIST ** ** NBUFF - NO. OF ELEMENTS IN SCAT/GAT ** ** TIMEOUT - COMMAND COMPLETION TIMEOUT ** (SECS) ** ( 0 = DEFAULT SET BY DRIVER ** -1 = INFINITE ) ** ** CDB_BYTE0 - OPERATION CODE ** ** ( LUN AND 21BIT STARTING LOGICAL BLOCK ADDR ) ** CDB_BYTE1 - BITS 5-7: LUN (ZERO) ** - BITS 0-4: MSB ** CDB_BYTE2 ** CDB_BYTE3 - LSB ** ** CDB_BYTE4 - COMMAND SPECIFIC ** ( - TRANSFER LENGTH, ** - PARAMETER LIST LENGTH OR ** - ALLOCATION LENGTH ) ** ** CDB_BYTE5 - CONTROL FIELD ** BIT 0: LINK BIT ** BIT 1: FLAG BIT ** BITS 2-5: RESERVED ** BITS 6-7: VENDOR SPECIFIC dd_CDB6 $DLL=SCSIADD \ DRIVEHANDLE=NUM \ DRVNAME=STRING \ MODE=NUM \ UNITHANDLE=NUM \ MEMSIZE=NUM \ NBUFF=NUM \ TIMEOUT=NUM \ CDB_BYTE0=NUM \ CDB_BYTE1=NUM \ CDB_BYTE2=NUM \ CDB_BYTE3=NUM \ CDB_BYTE4=NUM \ CDB_BYTE5=NUM \ $FUNC=_scsiadd_CDB6 ****************************************************************************** ** THE FOLLOWING FUNCTION CLOSES TEST DEVICE DRIVER: DASDADD$ (DASDADD.SYS) ** ** REQUIRED INPUT PARAMETERS: DRIVEHANDLE - (SET BY DD_OPEN) ** ** OUTPUT PARAMETERS: NONE ** ** LOGGED DATA: NONE ** ** dd_close $DLL=SCSIADD \ DRIVEHANDLE=NUM \ $FUNC=_scsiadd_close ****************************************************************************** ** Reads information about the capacity of the logical unit. ** It returns the logical block address and the block length in bytes of the ** - last logical block on the logical unit OR ** - the logical block after which a substantial ** delay in data transfer will be encountered. ** ** ** REQUIRED INPUT PARAMETERS: DRIVEHANDLE (SET BY DD_OPEN) ** ** DRVNAME - CHARACTER DRIVER NAME ** ** MODE - (0 OR 1) OPTIONAL ** DEFAULT=0 (ASYNC MODE) ** ** UNITHANDLE - SET IN SCSICOM.SCR. ** THIS IS OBTAINED BY ** CALLING DD_GETDEVICETABLE ** ** NBUFF - NO. OF ELEMENTS IN SCAT/GAT ** ** TIMEOUT - COMMAND COMPLETION TIMEOUT ** (SECS) ** ( 0 = DEFAULT SET BY DRIVER ** -1 = INFINITE ) ** ** SCATGAT - NAME FOR THE SCATGAT BUFFER ** ** LABEL - NAME FOR THE PARAMBLOCK ** ** ADDR_MODE - RELATIVE ADDRESS MODE ** ** LOGICAL_BLOCK_ADDR - STARTING LOGICAL BLOCK ADDRESS ** ** ** OUTPUT PARAMETERS: LAST_LOGICAL_BLOCK_ADDR (SETS) ** LOGICAL_BLOCK_SIZE (SETS) ** ** LOGGED DATA: LAST_LOGICAL_BLOCK_ADDR ** LOGICAL_BLOCK_SIZE ** READCAPACITY $DLL=SCSIADD \ $FUNC=_scsiadd_ReadCapacity\ DRIVEHANDLE=NUM\ DRVNAME=STRING \ UNITHANDLE=NUM \ TIMEOUT=NUM \ LABEL=STRING\ $FUNC=_scsiadd_ReadCapacity ****************************************************************************** ** Reads the most recent data from the addressed logical blocks. ** Cache control bits can be set. ** ** ** REQUIRED INPUT PARAMETERS: DRIVEHANDLE - (SET BY DD_OPEN) ** ** OUTPUT PARAMETERS: ** ** LOGGED DATA: ** ** READ10 $DLL=SCSIADD \ DRIVEHANDLE=NUM \ DRVNAME=STRING \ UNITHANDLE=NUM \ TIMEOUT=NUM \ LABEL=STRING \ LOGICAL_BLOCK_SIZE=NUM \ NUM_BLOCKS=NUM \ LOGICAL_BLOCK_ADDR=STRING \ FORCE_MEDIA_ACCESS=NUM \ CACHE_IF_POSSIBLE=NUM \ $FUNC=_scsiadd_Read10 ****************************************************************************** ** Reads the most recent data from the addressed logical blocks. ** Cache control bits CANNOT be set. ** ** ** REQUIRED INPUT PARAMETERS: DRIVEHANDLE - (SET BY DD_OPEN) ** ** OUTPUT PARAMETERS: ** ** LOGGED DATA: ** ** READ6 $DLL=SCSIADD \ DRIVEHANDLE=NUM \ DRVNAME=STRING \ UNITHANDLE=NUM \ TIMEOUT=NUM \ LABEL=STRING \ LOGICAL_BLOCK_SIZE=NUM \ NUM_BLOCKS=NUM \ LOGICAL_BLOCK_ADDR=STRING \ $FUNC=_scsiadd_Read6 ****************************************************************************** ** Seeks to the specified logical block address. ** ** ** REQUIRED INPUT PARAMETERS: DRIVEHANDLE - (SET BY DD_OPEN) ** ** OUTPUT PARAMETERS: ** ** LOGGED DATA: ** ** SEEK6 $DLL=SCSIADD \ DRIVEHANDLE=NUM \ DRVNAME=STRING \ UNITHANDLE=NUM \ TIMEOUT=NUM \ LABEL=STRING \ LOGICAL_BLOCK_ADDR=STRING \ $FUNC=_scsiadd_Seek6 ****************************************************************************** ** Sets the logical unit to a specific state. Details are vendor specific. ** ** ** REQUIRED INPUT PARAMETERS: DRIVEHANDLE - (SET BY DD_OPEN) ** ** OUTPUT PARAMETERS: ** ** LOGGED DATA: ** ** REZERO_UNIT $DLL=SCSIADD \ DRIVEHANDLE=NUM \ DRVNAME=STRING \ UNITHANDLE=NUM \ TIMEOUT=NUM \ LABEL=STRING \ $FUNC=_scsiadd_RezeroUnit ****************************************************************************** ** Reads the specified logical blocks into the adapter's cache memory. ** ** REQUIRED INPUT PARAMETERS: DRIVEHANDLE - (SET BY DD_OPEN) ** ** OUTPUT PARAMETERS: ** ** LOGGED DATA: ** ** PREFETCH $DLL=SCSIADD \ DRIVEHANDLE=NUM \ DRVNAME=STRING \ UNITHANDLE=NUM \ TIMEOUT=NUM \ LABEL=STRING \ LAST_LOGICAL_BLOCK_ADDR=STRING \ LOGICAL_BLOCK_SIZE=NUM \ NUM_BLOCKS=NUM \ STATUS_RETURN_IMMED=NUM \ LOGICAL_BLOCK_ADDR=NUM \ $FUNC=_scsiadd_PreFetch ****************************************************************************** ** Enables or Disables the removal of the media in the logical unit. ** ** REQUIRED INPUT PARAMETERS: DRIVEHANDLE - (SET BY DD_OPEN) ** ** OUTPUT PARAMETERS: ** ** LOGGED DATA: ** ** LOCK_UNLOCK_MEDIA $DLL=SCSIADD \ DRIVEHANDLE=NUM \ DRVNAME=STRING \ UNITHANDLE=NUM \ TIMEOUT=NUM \ LABEL=STRING \ LOCK_UNLOCK=NUM \ $FUNC=_scsiadd_LockUnlockMedia ****************************************************************************** ** Enables or Disables the media access operations on the logical unit. ** ** REQUIRED INPUT PARAMETERS: DRIVEHANDLE - (SET BY DD_OPEN) ** ** OUTPUT PARAMETERS: ** ** LOGGED DATA: ** ** START_STOP_UNIT $DLL=SCSIADD \ DRIVEHANDLE=NUM \ DRVNAME=STRING \ UNITHANDLE=NUM \ TIMEOUT=NUM \ LABEL=STRING \ STATUS_RETURN_IMMED=NUM \ START_STOP=NUM \ LOAD_EJECT=NUM \ $FUNC=_scsiadd_StartStopUnit ****************************************************************************** ** Ensures that the logical blocks in the cache memory, within the specified ** range, have their most recent data value recorded on the physical medium. ** ** REQUIRED INPUT PARAMETERS: DRIVEHANDLE - (SET BY DD_OPEN) ** ** OUTPUT PARAMETERS: ** ** LOGGED DATA: ** ** SYNC_CACHE $DLL=SCSIADD \ DRIVEHANDLE=NUM \ DRVNAME=STRING \ UNITHANDLE=NUM \ TIMEOUT=NUM \ LABEL=STRING \ LAST_LOGICAL_BLOCK_ADDR=STRING \ LOGICAL_BLOCK_SIZE=NUM \ NUM_BLOCKS=NUM \ STATUS_RETURN_IMMED=NUM \ LOGICAL_BLOCK_ADDR=STRING \ $FUNC=_scsiadd_Sync_Cache ****************************************************************************** ** Writes data to the medium. Cache control bits are not provided. ** ** REQUIRED INPUT PARAMETERS: DRIVEHANDLE - (SET BY DD_OPEN) ** ** OUTPUT PARAMETERS: ** ** LOGGED DATA: ** ** WRITE6 $DLL=SCSIADD \ DRIVEHANDLE=NUM \ DRVNAME=STRING \ UNITHANDLE=NUM \ TIMEOUT=NUM \ LABEL=STRING \ LOGICAL_BLOCK_SIZE=NUM \ NUM_BLOCKS=NUM \ LOGICAL_BLOCK_ADDR=STRING \ SCATGAT=STRING \ $FUNC=_scsiadd_Write6 ****************************************************************************** ** Writes data to the medium. Cache control bits can be set. ** ** REQUIRED INPUT PARAMETERS: DRIVEHANDLE - (SET BY DD_OPEN) ** ** OUTPUT PARAMETERS: ** ** LOGGED DATA: ** ** WRITE10 $DLL=SCSIADD \ DRIVEHANDLE=NUM \ DRVNAME=STRING \ UNITHANDLE=NUM \ TIMEOUT=NUM \ LABEL=STRING \ LOGICAL_BLOCK_SIZE=NUM \ NUM_BLOCKS=NUM \ LOGICAL_BLOCK_ADDR=STRING \ FORCE_MEDIA_ACCESS=NUM \ CACHE_IF_POSSIBLE=NUM \ SCATGAT=STRING \ $FUNC=_scsiadd_Write10 ****************************************************************************** ** Writes the data to the medium and verifies if data is correctly written. ** ** REQUIRED INPUT PARAMETERS: DRIVEHANDLE - (SET BY DD_OPEN) ** ** OUTPUT PARAMETERS: ** ** LOGGED DATA: ** ** WRITE_AND_VERIFY $DLL=SCSIADD \ DRIVEHANDLE=NUM \ DRVNAME=STRING \ UNITHANDLE=NUM \ TIMEOUT=NUM \ LABEL=STRING \ LOGICAL_BLOCK_SIZE=NUM \ NUM_BLOCKS=NUM \ LOGICAL_BLOCK_ADDR=STRING \ BYTE_CHECK=NUM \ CACHE_IF_POSSIBLE=NUM \ SCATGAT=STRING \ $FUNC=_scsiadd_WriteAndVerify ****************************************************************************** ** Writes the single block of data to the medium multiple times. ** ** REQUIRED INPUT PARAMETERS: DRIVEHANDLE - (SET BY DD_OPEN) ** ** OUTPUT PARAMETERS: ** ** LOGGED DATA: ** ** WRITE_SAME $DLL=SCSIADD \ DRIVEHANDLE=NUM \ DRVNAME=STRING \ UNITHANDLE=NUM \ TIMEOUT=NUM \ LABEL=STRING \ LAST_LOGICAL_BLOCK_ADDR=STRING \ LOGICAL_BLOCK_SIZE=NUM \ NUM_BLOCKS=NUM \ LOGICAL_BLOCK_ADDR=STRING \ LOGICAL_BLOCK_DATA=NUM \ PHYSICAL_BLOCK_DATA=NUM \ SCATGAT=STRING \ $FUNC=_scsiadd_WriteSame ****************************************************************************** ** Reads the most recent data from the addressed logical block (reads only ** one block). The data passed is vendor- specific, but shall include the ** data bytes and the ECC bytes recorded on the medium. ** ** REQUIRED INPUT PARAMETERS: DRIVEHANDLE - (SET BY DD_OPEN) ** ** OUTPUT PARAMETERS: ** ** LOGGED DATA: ** ** READ_LONG $DLL=SCSIADD \ DRIVEHANDLE=NUM \ DRVNAME=STRING \ UNITHANDLE=NUM \ TIMEOUT=NUM \ LABEL=STRING \ LOGICAL_BLOCK_SIZE=NUM \ NUM_BYTES=NUM \ LOGICAL_BLOCK_ADDR=STRING \ ECC_CORRECT=NUM \ $FUNC=_scsiadd_ReadLong ****************************************************************************** ** Writes data to the medium(writes only one block). ** The data passed is implementation - specific, but shall include the data ** bytes and the ECC bytes recorded on the medium. The READ LONG command is ** usually issued before issuing a WRITE LONG command. ** ** REQUIRED INPUT PARAMETERS: DRIVEHANDLE - (SET BY DD_OPEN) ** ** OUTPUT PARAMETERS: ** ** LOGGED DATA: ** ** WRITE_LONG $DLL=SCSIADD \ DRIVEHANDLE=NUM \ DRVNAME=STRING \ UNITHANDLE=NUM \ TIMEOUT=NUM \ LABEL=STRING \ LOGICAL_BLOCK_SIZE=NUM \ NUM_BYTES=NUM \ LOGICAL_BLOCK_ADDR=STRING \ SCATGAT=STRING \ $FUNC=_scsiadd_WriteLong ****************************************************************************** ** Defines the range within which subsequent linked commands may operate. ** ** REQUIRED INPUT PARAMETERS: DRIVEHANDLE - (SET BY DD_OPEN) ** ** OUTPUT PARAMETERS: ** ** LOGGED DATA: ** ** SET_LIMITS $DLL=SCSIADD \ DRIVEHANDLE=NUM \ DRVNAME=STRING \ UNITHANDLE=NUM \ TIMEOUT=NUM \ LABEL=STRING \ LAST_LOGICAL_BLOCK_ADDR=STRING \ LOGICAL_BLOCK_SIZE=NUM \ NUM_BLOCKS=NUM \ WRITE_INHIBIT=NUM \ READ_INHIBIT=NUM \ LOGICAL_BLOCK_ADDR=STRING \ $FUNC=_scsiadd_SetLimits ****************************************************************************** ** Verifies the data written on the medium. ** ** REQUIRED INPUT PARAMETERS: DRIVEHANDLE - (SET BY DD_OPEN) ** ** OUTPUT PARAMETERS: ** ** LOGGED DATA: ** ** VERIFY $DLL=SCSIADD \ DRIVEHANDLE=NUM \ DRVNAME=STRING \ UNITHANDLE=NUM \ TIMEOUT=NUM \ LABEL=STRING \ LOGICAL_BLOCK_SIZE=NUM \ NUM_BLOCKS=NUM \ BYTE_CHECK=NUM \ CACHE_IF_POSSIBLE=NUM \ LOGICAL_BLOCK_ADDR=STRING \ $FUNC=_scsiadd_Verify ****************************************************************************** ** Request the target device to Allow or Disallow logical blocks within the ** specified range to be removed from the cache memory. ** ** REQUIRED INPUT PARAMETERS: DRIVEHANDLE - (SET BY DD_OPEN) ** ** OUTPUT PARAMETERS: ** ** LOGGED DATA: ** ** LOCK_UNLOCK_CACHE $DLL=SCSIADD \ DRIVEHANDLE=NUM \ DRVNAME=STRING \ UNITHANDLE=NUM \ TIMEOUT=NUM \ LABEL=STRING \ LAST_LOGICAL_BLOCK_ADDR=STRING \ LOGICAL_BLOCK_SIZE=NUM \ NUM_BLOCKS=NUM \ LOCK_CACHE=NUM \ LOGICAL_BLOCK_ADDR=STRING \ $FUNC=_scsiadd_LockUnlockCache ****************************************************************************** ** ** ** REQUIRED INPUT PARAMETERS: DRIVEHANDLE - (SET BY DD_OPEN) ** ** OUTPUT PARAMETERS: ** ** LOGGED DATA: ** ** READ_DEFECT_DATA $DLL=SCSIADD \ DRIVEHANDLE=NUM \ DRVNAME=STRING \ UNITHANDLE=NUM \ TIMEOUT=NUM \ LABEL=STRING \ NUM_BYTES=NUM \ DEFECT_LIST_FORMAT=NUM \ GROWN_DEFECT_LIST=NUM \ PRIMARY_DEFECT_LIST=NUM \ $FUNC=_scsiadd_ReadDefectData ****************************************************************************** ** Returns information regarding parameters of the target and its attached ** peripheral device(s). ** ** REQUIRED INPUT PARAMETERS: DRIVEHANDLE - (SET BY DD_OPEN) ** ** OUTPUT PARAMETERS: ** ** LOGGED DATA: ** ** INQUIRY $DLL=SCSIADD \ DRIVEHANDLE=NUM \ DRVNAME=STRING \ UNITHANDLE=NUM \ TIMEOUT=NUM \ LABEL=STRING \ NUM_BYTES=NUM \ ENABLE_VITAL_PRODUCT_DATA=NUM \ CODE_PAGE=NUM \ $FUNC=_scsiadd_Inquiry ****************************************************************************** ** Checks if the logical unit is ready. ** ** REQUIRED INPUT PARAMETERS: DRIVEHANDLE - (SET BY DD_OPEN) ** ** OUTPUT PARAMETERS: ** ** LOGGED DATA: ** ** TEST_UNIT_READY $DLL=SCSIADD \ DRIVEHANDLE=NUM \ DRVNAME=STRING \ UNITHANDLE=NUM \ TIMEOUT=NUM \ LABEL=STRING \ $FUNC=_scsiadd_TestUnitReady ****************************************************************************** ** Requests the target to perform diagnostic operations on itself. ** ** REQUIRED INPUT PARAMETERS: DRIVEHANDLE - (SET BY DD_OPEN) ** ** OUTPUT PARAMETERS: ** ** LOGGED DATA: ** ** SEND_DIAGNOSTIC $DLL=SCSIADD \ DRIVEHANDLE=NUM \ DRVNAME=STRING \ UNITHANDLE=NUM \ TIMEOUT=NUM \ LABEL=STRING \ NUM_BYTES=NUM \ UNIT_OFF_LINE=NUM \ DEVICE_OFF_LINE=NUM \ SELF_TEST=NUM \ PAGE_FORMAT=NUM \ $FUNC=_scsiadd_SendDiagnostic ****************************************************************************** ** Releases the previously reserved logical unit. ** ** REQUIRED INPUT PARAMETERS: DRIVEHANDLE - (SET BY DD_OPEN) ** ** OUTPUT PARAMETERS: ** ** LOGGED DATA: ** ** RELEASE $DLL=SCSIADD \ DRIVEHANDLE=NUM \ DRVNAME=STRING \ UNITHANDLE=NUM \ TIMEOUT=NUM \ LABEL=STRING \ EXTENT_RELEASE=NUM \ THIRD_PARTY_RELEASE=NUM \ RESERVATION_ID=NUM \ $FUNC=_scsiadd_Release ****************************************************************************** ** Reserves a logical unit. ** ** REQUIRED INPUT PARAMETERS: DRIVEHANDLE - (SET BY DD_OPEN) ** ** OUTPUT PARAMETERS: ** ** LOGGED DATA: ** ** RESERVE $DLL=SCSIADD \ DRIVEHANDLE=NUM \ DRVNAME=STRING \ UNITHANDLE=NUM \ TIMEOUT=NUM \ LABEL=STRING \ EXTENT_RESERVE=NUM \ THIRD_PARTY_RESERVE=NUM \ RESERVATION_ID=NUM \ $FUNC=_scsiadd_Reserve